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ABSTRACT 


An  Interactive  and  versatile  program  warn  written  for  a  VAX/VMS  system  to 
plot  and  manipulate  the  results  of  some  simulation  programs.  It  was  first 
developed  to  display  results  from  SPI'E  (a  circuit  simulation  prog  m)  but  has 
been  modified  to  accept  almost  any  data  in  ASCII  files.  An  other  version  of  the 
program  was  written  for  the  plotting  and  manipulation  of  results  during  the 
simulations.  This  document  provides  a  detailed  description  of  the  programs  and 
their  commands. 


RfisqttE 


On  programme  a  6t6  conqu  pour  un  systSme  VAX/VMS  pour  afflcher  et  manlpuler 
les  r&sultats  de  programmes  de  simulation.  II  a  it6  initlalemenc  d£velopp£  pour 
pouvoir  afflcher  les  rdsultats  de  SPICE  (un  programme  de  simulation  de  circuits), 
mais  a  <t£  ultSrieurement  modlfie  pour  accepter  des  donnfies  de  fichiers  ASCII. 
Une  autre  version  du  programme  a  6t6  6crite  pour  permettre  l'affichage  de 
rSsultats  durant  1 ’execution  de  programmes  de  simulation.  Ce  rapport  donne  une 
description  detailld  des  programmes  et  de  leurs  commandes. 
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EXECUTIVE  SUMMARY 


This  program  (SPLOT)  was  written  at  DREO  to  provide  Interactive  graphics 
on  a  VAX/VMS  system  to  display  the  results  of  various  scientific  simulation 
codes . 


SPLOT  Is  available  In  two  forms:  as  a  stand-alone  program  or  as  a 
subroutine.  The  stand-alone  version  can  display  the  results  of  most  simulation 
codes  (stored  in  ASCII  files)  while  the  subroutine  version  easily  interacts  with 
user-written  codes  to  display  results  during  the  simulation. 

SPLOT  was  first  designed  to  enhance  the  very  limited  plotting  capability 
of  SPICE.  SPICE  Is  a  general-purpose  circuit  simulation  program  for  nonlinear 
DC  and  transient  analysis,  and  for  linear  AC  analysis.  No  changes  are  required 
to  SPICE  and  its  output  can  be  directly  read  by  SPLOT  for  plotting. 

In  addition  to  the  SPICE-format ,  SPLOT  supports  ASCII  files  written  In  its 
own  format  (SPLOT- format)  or  in  free-format. 

Some  of  the  features  of  SPLOT  includes  the  ability  to:  read  multiple  data 
sets  from  different  files,  plot  multiple  curves,  select  logarithmic  axis,  scale 
and  zoom  plots,  manipulate  the  data  (add,  move,  scale,  shift,  etc)  and  edit  plot. 


v 


TABLE  Or  CONTENTS 


PACE 

ABSTRACT . ill 

EXECUTIVE  SUMMARY  .  v 

TABLE  OF  CONTENTS . vll 

1.0  INTRODUCTION  .  1 

1.1  GENERAL  DESCRIPTION  .  1 

1.2  RUNNING  THE  SPLOT  PROGRAM  .  2 

1.3  CALLING  THE  SPLOT  SUBROUTINE  .  2 

1.4  LOADING  DATA . 3 

2.0  FILE  FORMAT  DESCRIPTION  .  5 

2.1  SPICE  FORMAT .  5 

2.2  SPLOT  FORMAT  .  5 

2.3  FREE  FORMAT .  11 

3.0  COMMANDS  DESCRIPTION  .  12 

3.1  SPECIFYING  CURVES  .  14 

3.2  CONTROL  COMMANDS .  15 

3.2.1  <CR> .  15 

3.2.2  END.  EXIT,  QUIT  or  CTRL/Z .  15 

3.2.3  PRINT .  15 

3.2.4  SAVE .  16 

3.2.5  SPAWN .  16 

3.3  DATA  FILE  COMMANDS .  16 

3.3.1  NEXT .  17 

3.3.2  NEW .  17 

3.3.3  REWIND .  17 

3.3.4  BMOVE .  17 

3.4  GRAPHIC  COMMANDS  .  18 

3.4.1  DASH  coamand .  18 

vli 


3.4.2  GRID  command .  18 

3.4.3  SYMBOL  command .  20 

3.4.4  TZTC  command .  22 

3.4.3  TXTL  command .  23 

3.4.6  TITR  command .  23 

3.4.7  XLABEL  command .  23 

3.4.8  XSCALE  command .  24 

3.4.9  WINDOW  command .  24 

3.4.10  YSCALE  command  .  24 

3.4.11  WINDOW  command .  25 

3.5  DATA  MANIPULATION  COMMANDS .  25 

3.3.1  ABS  command .  25 

3.5.2  ADD.  SUB.  MUL  and  DIV  commands .  25 

3.3.3  ADDC,  SUBC,  MULC  and  DIYC  commands  .  26 

3.5.4  COMPRESS  command  .  26 

3.5.5  DB  command .  26 

3.3.6  INV  command .  27 

3.5.7  MOVE  or  COPY  commands .  27 

3.5.8  NEC  command .  27 

3.5.9  PHASE  command .  27 

3.5.10  ROT  command .  28 

3.5.11  SCALE  command  .  28 

3.5.12  SHIFT  comand . 29 

3.5.13  XCOMPRESS  command  .  29 

3.6  CURSOR  MODE  COMMANDS .  29 

3.6.1  CURSOR  command .  30 

3.6.2  <SP>,  Exit  cursor  mode .  30 

3.6.3  <0  command .  30 

3.6.4  <D>  command .  30 

3.6.5  command .  31 

3.6.6  <L>  command .  31 

3.6.7  <3t>  command .  31 

3.6.8  <P>  command .  31 

3.6.9  <R>  command .  31 

3.6.10  <S>  command .  31 

3.6.11  <V>  command .  32 

3.6.12  <Z>  command .  32 


vili 


1.0  INTRODUCTION 


An  Interactive  and  versatile  prograa  was  developed  at  the  Defence  Research 
Establishment  Ottawa  (DR£0)  to  aanipulate  and  display  in  a  graphical  form  the 
results  of  simulation  programs.  It  was  originally  developed  to  display  results 
from  SPICE  (a  circuit  simulation  program)  but  has  been  expanded  to  accept  data 
from  ASCII  files  using  several  different  formats. 

This  program  was  developed  on  a  VAX /VMS  system,  using  the  VAX  FORTRAN- 77 
compiler  and  using  the  Tektronix  Advance  Graphlng-II  software.  This  program 
works  well  with  the  Tektronix  401X  and  411X  series  and  with  the  DEC  VT2XX  and 
VT3XX  series  emulating  TEX401X  serle.  It  also  works  well  on  personal  computers 
with  Tektronix  emulation  software,  such  as  KERMIT  or  REFLECTION-4.  Hardcopy  is 
produced  on  a  DEC  LN03  laser  printer. 

Data  can  be  loaded  from  an  ASCII  file,  usually  generated  by  a  user's 
application  program,  conforming  to  one  of  the  formats  defined  in  Chapter  2.  The 
application  program  can  be  written  in  FORTRAN,  C  or  any  other  language,  as  long 
as  it  can  produce  an  ASCII  file  with  the  required  format. 

This  Technical  Note  provides  a  detailed  description  of  the  program  and  its 
commands . 


1.1  GENERAL  DESCRIPTION 

SPLOT  is  available  in  two  forms:  as  a  stand-alone  program  and  as  a  FORTRAN 
subroutine.  The  stand-alone  version  is  used  to  display  data  previously  stored 
into  one  or  more  files.  The  subroutine  version  can  be  linked  with  a  user 
application  and  can  display  data  stored  in  FORTRAN  arrays.  The  subroutine 
version  also  has  file  support,  allowing  to  simultaneously  display  data  from 
arrays  and  files.  With  the  exception  of  the  initial  loading  method  and  few 
others  exceptions,  the  two  versions  are  similar  and  the  description  in  the 
following  sections  Is  applicable  to  both,  except  where  noted. 

SPLOT  loads,  manipulates  and  displays  data  stored  into  internal  arrays 
(real,  single  precision).  Those  arrays  are  numbered  sequentially  from  1  to  40 


1 


and  are  noted  as  A(l)  to  A(40)  throughout  this  report  (A(i..j)  denotes  the  block 
of  arrays  1  to  J).  Any  array  can  be  referenced  and  manipulated  interactively 
A  data  set  consists  of  a  number  of  arrays  (between  2  and  9)  of  Identical  size, 
retrieved  from  a  file  or  passed  as  arguments.  Each  data  set  Is  given  a  unique 
ID  associated  with  each  of  tha  arrays.  S?LOT  will  always  load  a  data  set  Into 
arrays  A(1..9).  This  data  can  be  moved  to  other  arrays  and  more  data  can  then 
be  loaded.  SPLOT  provides  a  full  sat  of  interactive  commands  to  manipulate  the 
arrays  and  to  display  up  to  16  curves  on  a  single  graph. 


1.2  RUNNING  THE  SPLOT  PROGRAM 

SPLOT  Is  executed  by  simply  entering  the  "RUN  SPLOT"  VMS  command  or  by 
typing  "SPLOT"  If  the  user's  account  has  been  setup  appropriately  by  the  system 
manager.  If  a  VT2XX  or  VT3XX  series  terminal  is  used,  it  must  be  switched  to 
Tektronix  emulation  mode  before  the  program  is  started  (this  can  be  done 
automatically  If  the  account  is  setup  properly  by  the  system  manager). 

Upon  execution,  the  user  will  be  prompted  for  a  file  name,  from  which  the 
initial  data  set  can  be  loaded. 


1.3  CALLING  THE  SPLOT  SUBROUTINE 

The  subroutine  version  of  SPLOT  is  almost  identical  with  the  program 
version.  The  main  difference  is  that  the  initial  data  set  is  loaded  from  arrays 
passed  as  arguments  by  the  caller.  The  calling  syntax  is: 

Call  SPL0T2  (  nCurves.  Title,  Vars,  xl  ,  x2  .  x8  ) 

where : 

nCurves  (single  precision  Integer) 

The  number  of  data  arrays  (xl  to  x8)  passed  by  the  caller 

Title  (character  string) 

Title  to  be  displayed  on  the  prompt  screen  (see  below) 
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Van  (character  string) 

List  of  variables  to  be  displayed  on  the  prompt  screen  (see 
below) 

xl  to  xS  (single  precision  real) 

Arrays  containing  the  data  polnta.  The  first  element  of  each 
array  contains  the  number  of  data  points,  followed  by  the  data 
Itself.  Only  the  number  of  arrays  specified  by  'nCurves'  need 
to  be  passed  as  arguments.  All  arrays  need  not  to  contain  the 
same  number  of  points,  in  which  case,  arrays  of  different  size 
are  treated  as  separated  data  sets  (and  thus  given  a  different 
ID). 

The  arrays  xl  to  x8  can  be  defined  with  a  different  origin  to  facilitate  the 
programming.  For  Instance,  if  a  user  program  defines  the  arrays  "REAL  x(100), 
y(100).  z(100)",  the  simplest  way  to  add  tha  size  of  the  array  in  front  of  it  Is 
to  define  them  as  "REAL  x(0:100),  y(0:100),  z(0:100)”  and  store  100  in  x(0) .  y(0) 
and  z(0) . 

When  linking  the  application  program,  the  following  files  must  be  specific  ’ 
(their  exact  location  can  be  obtained  from  the  system  manager): 

SUB- PLOT- V2 ,  PLOTIO-UTL/Library,  PL0T1 0/Library 

1.4  LOADING  DATA 

The  data  can  be  loaded  from  different  sources  (arrays  or  files),  but 
regardless  of  the  source,  SPLOT  will  attempt  to  retrieve  the  following 
information:  a  title,  a  list  of  variables  ard  a  block  of  data.  The  title  is 
optional  and  will  be  displayed  with  the  command  prompt.  The  list  of  variables 
is  also  optional  and,  if  present,  will  be  displayed  also  with  the  command  prompt. 
It  identifies  the  data  last  loaded  into  arrays  A(1..9).  The  block  of  data 
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contains  2  fo  <  columns  of  'n'  points  which  will  be  stored  Into  arrays  All. . 9 ) . 
For  Instance.  If  the  title  and  the  list  of  variables  are: 

Title:  SAMPLE  TITLE  Ol-Jan-91 

List:  t  Vln  Vout  Iln  lout 

the  following  screen  will  appear  at  the  prompt: 

sample  title  oi-jan-9i 

1  -  t 

2  -  Vln 

3  -  Vout 
A  -  lin 
5  -  lout 

Command: 

If  neither  the  title  or  the  list  of  variables  Is  found,  only  the  "Command:  " 
prompt  will  be  displayed. 


2.0  FILE  FORMAT  DESCRIPTION 


SPLOT  was  originally  designed  co  plot  tha  results  of  the  SPICE  cir  -lr 
simulation  program  without  the  need  of  modifying  SPICE  itself.  It  was  later 
modified  to  accept  different  file  formats,  making  SPLOT  a  very  versatile  tool  for 
displaying  tha  results  of  varlout  emulation  programs.  This  section  describes 
in  detail  each  of  the  formats. 


2 . 1  SPICE  FORMAT 

SPICE  is  a  general 'purpose  program  for  simulating  passive  and  active 
circuits.  It  can  perform  nonlinear  DC  and  transient  analysis  and  linear  AC 
analysis.  An  example  of  a  SPICE  input  file  is  shown  in  Figure  2-1. 

The  ".PRINT"  control  statement  highlighted  In  Figure  2-1  must  be  specified 
to  instruct  SPICE  to  write  the  desired  results  into  the  output  file,  usually  the 
current  or  the  voltage  at  one  or  several  nodes.  Refer  to  the  SPICE  user  guide 
for  a  complete  description  of  the  program. 

The  results  of  the  simulation  are  written  into  an  output  file,  which  must 
have  a  file  name  extension  ".SPO"  (eg.  "DEMO.SPO")  for  SPLOT  to  recognise  Its 
format.  SPLOT  will  automatically  locate  and  load  the  data  generated  by  the 
".PRINT"  option.  More  than  one  set  of  data  (multiple  ".PRINT"  command)  may  be 
present  in  the  file;  they  will  be  loaded  sequentially.  An  extract  of  a  SPICE 
output  file  is  shown  In  Figure  2-2. 


2.2  SPLOT  FORMAT 

This  format  is  derived  from  the  SPICE  format  -ermits  the  Inclusion  of 

titles,  lists  of  variables  and  multiple  sets  of  data  within  a  single  file.  This 
is  the  most  versatile  format  as  it  allows  one  to  plot  data  from  multiple  data  set 
from  one  or  many  files.  Files  that  conform  tc  this  format  are  easily  generated 
by  user  programs  written  in  C  or  FORTRAN.  Figure  2-3  shows  a  typical  (skeleton) 
program  used  to  generate  a  SPLOT  file.  Typically,  a  data  set  In  a  file 

created  with  three  WRITE  statements.  The  first  one  create  a  header,  the  second 
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!••*••••  1  -AUO-ta  Vice  70. •  3/1S/I3 

ODOB  1  --  l%l*  i|«ta:  lat-w^H  t  2aO-ardar  flltara  la  eaaeada 

TWMIOT  MULTSIS  TOTCIUTURC  -  27.000  OEO  C 


TIME 

I 

*0) 

V<2) 

»(b> 

o.oooc+oo 

O.OOOEtOO 

O.OOOEtOO 

O.OOOEtOO 

1.000E-04 

O.OOOEtOO 

O.OOOEtOO 

O.OOOEtOO 

2. OSS-04 

O.OOOEtOO 

O.OOOEtOO 

O.OOOEtOO 

3  000C-O4 

O.OOOEtOO 

O.OOOEtOO 

O.OOOEtOO 

4.000E-04 

O.OOOEtOO 

O.OOOEtOO 

O.OOOEtOO 

S.L100E-04 

O.OOOEtOO 

O.OOOEtOO 

O.OOOEtOO 

O.QuUi-Si 

o.oooEtoo 

a.aoaEtoo 

O.OOOEtOO 

7.000E-04 

O.OOQEtOO 

O.OOOEtOO 

O.OOOEtOO 

I.0OOEO4 

O.OOOEtOO 

O.OOOEtOO 

O.OOOEtOO 

a.QOOE-04 

O.OOOEtOO 

o.aouEtao 

O.OOOEtOO 

1 .OOOE-03 

O.OOOEtOO 

O.OOOEtOO 

O.OOOEtOO 

t . 100€ -03 

Q.OOOEtUQ 

O.OOOEtOO 

O.OOOEtOO 

3.M0C-02 

O.OOOEtOO 

3.032E-10 

-2.050E-05 

3.900C-02 

O.OOOEtOO 

3.142E-10 

-1.1S1E-0S 

4.000E-02 

O.OOOEtOO 

2.551E-10 

-2.321E-07 

T 


Figure  2-2.  Sample  SPICE  output  £ile. 
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DOB  1  -•  Staple  aystaa:  lat-wder  t  2nd-ordar  filter*  ta  c— cart* 


.OPT  LIST  WOI  L1MPTS-S00 
VIM  1  0  PULSC(OV  IV  2ms  OB  OKS  2BB)  AC 

Ml  1  2  SO  (MB 

Cl  20  10UF 

Cbafl  3  0  2  0  1 

M2  3  4  1.200MI 

L2  4S1W 
C2  SO  2SUF 
THAN  .IMS  40MS 
IpPIMT  THAN  V(1>  V(2)  VfS) 

.AC  DEC  10  10M2  1000RHZ 
.PM1MT  AC  VM(2)  VM(S) 

.am 


Figure  2-1.  Sample  SFZCE  Input  file. 
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one  included  in  a  00  loop  writes  the  setuel  data  and  the  last  one  puts  an  ’end' 
marker. 


Figure  2-4  shows  an  extract  of  a  typical  data  file  containing  two  data  sets 
conforming  to  the  SPLOT  format.  The  first  column  of  every  line  (the  FORTRAN 
carriage  control  character)  is  used  as  a  control  character  and  trust  be  left  blank 
otherwise.  The  file  may  contain  multiple  data  sets. 

Each  data  set  consists  of: 

•  a  form- feed  ('1'  in  column  1),  marking  the  beginning  of  a  new  data 
set. 

•  an  optional  title  line  as  *T*  in  column  1,  followed  by  a  title.  For 
compatibility  with  older  versions  of  SPLOT,  *0’  in  column  1  is  also 
valid,  but  discouraged. 

•  an  optional  list  of  variables  as  ’V’  in  column  1,  followed  by  the 
list  of  variables,  each  separated  with  a  space. 

•  some  optional  comment  lines,  with  a  space  In  column  1. 

•  'X'  in  column  1,  marking  the  beginning  of  the  data  area. 

•  the  data  area,  with  a  space  in  column  1,  organized  as  rn'  lines  of 
•m*  columns,  which  will  be  loaded  into  ’m’  arrays  of  'n*  points. 
Numbers  on  a  line  can  be  separated  by  spaces,  tabs  or  comma 
(multiple  spaces  or  tabs  are  treated  as  single). 

•  'Y'  in  column  1,  marking  the  end  of  the  data  area. 


The  optional  title  and  variable  list  are  displayed  when  the  user  is 
prompted  for  commands.  They  are  not  part  of  the  graph. 

Data  points  which  are  greater  than  103°  are  defined  as  'not-a-number ' . 
They  are  stored  as  data  point,  but  they  will  not  be  plotted. 
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M*l  yl.  yl.  y3.  ... 


Open  (llalt-i.  Umm'DCMO.DAT'  .Typan'MEV* ) 


■rlt#  (2.9001) 

9001  Feraat(  ‘1*. 

♦  /.‘T  TltU  Iik«- 

♦  /.'*  t  II  12  13  ...' 

♦  /.*»'  ) 

Oa  1-  1.  a 
yl  -  fct(i) 
y2  -  fctl(yl) 
y3  .  ... 


t  Nrlta  data  aat  haadar 
I  Mark  ba|1 nalng  of  naa  data  aat 

I  Optlaaal  tltla 

t  Optlaaal  Mat  ef  varlablaa 

t  Mark  bag Inning  af  data 


1  Oaaarata  data  hara 


trlta  (2.9002)  yl.  y2,  y3.  ...  I  Output  raault  to  flla 

9002  Faraat('  Mp.olO.3.  2x.  9(2a.a10.3)  ) 

Endda 


Wrlto  (2.9003) 
9003  •  .aot(-r) 


!  Nark  ard-of-data 


Figure  2-3.  Sample  program  to  generate  SPLOT  format  file. 
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1 

T9P10T  DOS. 

(tnnn 

i 

0.0002*00 

1.0002*00 

2.0002*00 

3.0002*00 

4.0002*00 

0.0002*00 

0.0002*00 

7.0002*00 

0.0002*00 

0.0002*00 

1.0002*01 

1.1002*01 

1.2002*01 


1.0002*01 

1.0002*01 

2.0002*01 

t 

1 

T3M.OT  DEMO 
»t  PI  P2  F3 
I 

0.0002*00 

1.0002*00 

2.0002*00 

3.0002*00 


0.0002*00 

0.0002*00 

1.0002*01 


,  DATA  SET  #1 
Mlllt 


0.0002*00 

0.0002*00 

0.0002*00 

0.0002*00 

0.0002*00 

2.0602*00 

2.0332*00 

1.4772*00 

1.9012*00 

2.322E*00 

3.3002*00 

3.0742*00 

2.2322*00 

2.0142*00 

2.7556*00 

4.003E*00 

4.4502*00 

2.5032*00 

2.0002*00 

2.5706*00 

4.5102*00 

4.7312*00 

2.0402*00 

2.5202*00 

2.2202*00 

4.7032*00 

4.0572*00 

2.5002*00 

2.2072*00 

1.0002*00 

4.9672*00 

4.0152*00 

2.4702*00 

1.0072*00 

1.5302*00 

5.0652*00 

4.9302*00 

2.3092*00 

1.7412*00 

1.2056*00 

5.1122*00 

4.0402*00 

2.1342*00 

1.5002*00 

1.0302*00 

5.1452*00 

4.0402*00 

1.0602*00 

1.3032*00 

0.5072-01 

5.1022*00 

4.0472*00 

1.7002*00 

1.1242*00 

0.0072-01 

5.1712*00 

4.0442*00 

1.0272*00 

0.0052-01 

5.7002-01 

5.1742*00 

4.0402*00 

1.4792*00 

9.341E-01 

4.0722-01 

5.1502*00 

4.9112*00 

•  •  • 

0.1702-01 

3.3042-01 

1.4072-01 

5.1512*00 

4.9002*00 

7.4002-01 

2.0212-01 

1.152E-01 

5.1402*00 

4.0012*00 

0.0072-01 

2.5142-01 

0.4332-02 

F4  PS  Fi 

0.0002*00 

0.0002*00 

0.0002*00 

0.0002*00 

0.0002*00 

-0.0312-01 

-1.0532*00 

-0.7122-01 

-0.7302-01 

•1.0142*00 

-1.4102*00 

•1.5502*00 

•1.0142*00 

•1.1056*00 

-1.2042*00 

-1.7412*00 

•1.7032*00 

•1.1062*00 

•1.1002*00 

•1.1232*00 

•2.1012*00 

•1.979E«00 

-0.0002-01 

-0.7212-01 

-4.5356-01 

-2.2052*00 

•1.9002*00 

-0.1002-01 

-5.0072-01 

-3.7106-01 

•2.2122*00 

-1 .0792*00 

-0.1202-01 

-5.0002-01 

-3.0446-01 

Figure  2-4.  Sample  SFLOT  format  file. 


0.0002*00 
2.5052*00 
2.7532*00 
2.3502*00 
1 .0902*00 
1.4042*00 
1.1092*00 
0.1152-01 
7.1032-01 
5.5332-01 
4.309E-01 
3.3582-01 
2.0142-01 


5.032E-02 
4. 5422-02 
3.5372-02 


0.0002*00 

-1.1002*00 

-1.1002*00 

-1.0102*00 


-3.0442-01 
-2.371E -01 
-1.0472-01 
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2.3  FREE  FORMAT 


If  SFLOT  falls  Co  find  In  cha  file  a  data  set  as  defined  In  the  previous 
section.  It  will  attenpt  to  Interpret  the  file  In  free  format.  It  will  be 
assuaed  that  the  file  contains  only  data,  with  no  control  lines  and  no  control 
character  In  coluan  1.  The  data  Bust  be  organized  as  'n'  lines  of  ’a'  coluans. 
Numbers  on  a  line  can  be  separated  by  spaces,  tabs  or  coaaa  (multiple  spaces  or 
tabs  are  treated  as  single).  Data  points  which  are  greater  than  IQ30  are  defined 
as  'not-a-number'  and  will  not  be  plotted.  Data  will  be  read  until  the 
end-of*flle  is  reached. 
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3.0  COMKAMDS  DESCRIPTION 


SPLOT  Is  sn  Interactive  program.  It  provides  commands  to  select  curves  for 
plotting,  to  load  data  from  files,  and  to  perform  operations  onto  the  data.  It 
also  has  the  capability  to  manipulate  interactively  the  plot  (zoom-in,  add 
titles,  lines  or  symbols). 

At  the  "Command:  "  prompt,  the  user  can  specify  a  curve,  enter  a  command 
or  hit  "<CR>"  to  draw  the  plot.  All  commands  can  be  abbreviated  to  four  letters. 
When  the  plot  is  completed,  the  program  will  either  wait  until  the  user  hits 
"<CR>"  in  normal  mode,  or  automatically  enter  the  cursor  mode  if  it  is  enabled 
(see  the  "CURSOR"  command). 

Sections  3.2  to  3.3  describe  in  detail  each  command  available  at  the 
"Command:  "  prompt.  When  a  command  requires  additional  arguments,  they  must 
follow  the  command  name,  on  the  same  line,  separated  by  a  space.  The  general 
syntax  is: 


COMMAND  al,a2 _ 

The  command  name  can  be  abbreviated  to  four  characters.  It  is  followed  by 
a  space  and  then  the  list  of  arguments.  Arguments  may  be  numerical  or  alpha- 
numerical.  Alphanumerical  Inputs  consist  of  all  text  from  the  first  non-blank 
character  after  the  command  name,  to  the  end  of  line,  including  all  spaces.  All 
numerical  Inputs  are  in  free  format  and  separated  with  commas  (”,").  They  may 
be  Integer  or  real  numbers.  When  noted  11,  12  or  13,  they  represent  the  index 
for  one  of  the  arrays  A(l.,40).  When  some  or  all  of  the  arguments  are  optional, 
they  are  put  in  brackets  "[  ]",  such  as: 

COMMAND  11 C . 12] 
or  COMMAND  t[xl,]x2] 

In  the  first  example,  the  second  argument  is  optional,  but  the  first  one 
must  be  specified.  In  the  second  example,  either  the  first  argument  or  both  are 
optional,  i.e.  the  combinations  "xl,x2",  "x2",  or  no  arguments,  are  valid.  Note 
that  if  the  last  argument  entered  is  zero,  it  is  considered  not  present. 
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Y-axls  label 


Figure  3*1.  Example  of  a  graph  produced  by  SPLOT. 


Figure  3-1  shows  a  typical  SPLOT  graph  of  four  curves  with  different  line 
styles  or  symbols,  titles  and  labels,  and  some  legends  added  with  the  cursor 
node. 


3.1  SPlCimjK  CORVES 

SPLOT  can  plot  up  to  16  curves  on  the  sane  graph.  Data  is  stored  Into  40 
arrays,  A(l)  to  A(40),  which  are  referred  to  by  specifying  their  index  (1  to  40). 
Any  array  can  be  plotted  against  any  other  array  having  the  same  ID.  One  or  more 
curves  can  be  specified  by  giving  the  abscissa  (x-axis)  first,  followed  by  one 
or  more  ordinates  (y-axls).  More  than  one  line  can  be  used  to  specify  more 
curves  or  to  plot  curves  from  different  data  set  on  the  same  graph.  In  this 
example: 

*i.  yu.  yis-  •••yin 

*2.  y«.  yss.  •••  y2- 

the  arrays  A(yu) .  A(yu) ,  ...  Aiy^J  are  plotted  against  and  the  arrays 

A{y21),  ACy^) ,  ...  ACy*.)  are  plotted  against  A(xa) .  SPLOT  will  automatically 
calculate  the  minimum  and  maximum  of  every  curve  and  setup  the  graph  so  they  all 
fit  in  it  (unless  some  other  limits  are  specified  with  the  "XVINDOU”  or  "YVINDOU” 
commands,  or  with  the  zoom  option  of  the  cursor  mode). 

Optionally,  each  array  specification  may  be  preceded  with  a  minus  sign 


t-lyu.  Myu.  •••  l-lyia 
[-1*2.  [-Jyn.  [-lyu.  •••  l-]y2» 

If  ”-Xi"  is  specified,  a  logarithmic  x-axls  will  be  produced.  If  "-y^  is 
specified,  a  logarithmic  y-axis  will  be  produced.  When  an  logarithmic  axis  is 
specified,  the  data  points  of  the  corresponding  arrays  which  are  zero  or  are 
negative  are  ignored.  This  allows  one  to  obtain  for  instance  a  logarithmic  plot 
of  a  frequency  response  even  if  a  DC  value  is  included  in  the  data  set. 
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If  the  sign  Is  specified  before  eny  ocher  array,  chat  array  will  not 
be  considered  when  computing  the  minimum  and  maximum  of  the  axis.  Part  of  the 
curve  may  then  fall  outside  the  drawing  area  and  will  be  clipped. 

After  one  or  more  lines  have  been  entered  for  specifying  curves,  an  empty 
line  ("<CR>")  la  used  to  draw  the  plot.  Dpon  return  to  the  "Command:  "  prompt, 
the  curve  specif lcations  will  remain  in  effect  until  new  specifications  are 
entered.  It  is  possible  to  used  most  of  the  commands  defined  in  the  following 
sections  without  affecting  the  curve  specifications.  There  are  however  few 
commands  which  will  clear  the  specifications  (those  which  loads  new  data) . 


3.2  CONTROL  COMMANDS 

Commands  in  this  group  provides  general  system-level  interaction. 


3.2.1  «a> 

An  empty  line  initiates  the  drawing  of  a  plot  of  all  the  curves  previously 
specified.  When  the  plot  is  completed,  the  terminal  will  'beep'  and  the  program 
will  pause  until  the  user  hits  "<CR>",  unless  the  cursor  mode  has  been  enabled 
(see  Section  3.6). 


3.2.2  END,  EXIT,  QUIT  or  CTRL/Z 

For  the  stand-alone  version,  this  command  terminates  SFLOT  and  returns  to 
the  DCL  prompt.  For  the  subroutine  version,  control  is  returned  to  the  caller. 
Data  arrays  10  to  40  and  most  Internal  variables  are  left  intact  and  may  be 
accessed  if  the  subroutine  is  called  again. 


3.2.3  FRUIT 

This  command  generates  a  hardcopy  of  the  last  plot  for  a  LN03-PLUS  laser 
printer,  using  the  form  LN03_TEK  (defined  by  the  system  manager),  on  the  print 
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queue  LN03$MY_QUEUE  (chls  logical  symbol  Is  defined  by  the  user  to  specify  the 
actual  queue).  This  command  should  be  used  immediately  after  returning  to  the 
"Command:  "  prompt.  "PRINT"  or  "SAVE"  can  only  be  called  once,  unless  the  plot 

is  drawn  again. 


3.2.4  SAVE 

This  command  saves  the  last  plot  in  the  file  SPLOT. SAV  (VMS  creates  e  new 
file  with  a  new  extension  every  time).  The  plot  is  stored  in  TEK-401X  format  and 
can  later  be  sent  to  a  LN03-PLUS  printer  or  redisplayed  on  a  terminal  screen. 
If  WordPerfect/VMS  is  available,  this  file  can  also  be  converted  into  WP-graphlcs 
format  (*.WPG  files)  and  be  imported  into  a  WordPerfect  document  or  other  PC 
utilities1.  "PRINT"  or  "Sav'E"  can  only  be  called  once,  unless  the  plot  is  drawn 
again. 


3.2.3  SPAM 


This  comsund  creates  a  sub -process  and  leaves 
Control  is  returned  to  SPLOT  when  the  user  logs-out 


the  user  at  the  DCL  prompt. 
("LOGOUT")  the  sub-process. 


3.3  DATA  FILE  COMMANDS 

Upon  entry,  an  initial  data  set  is  always  loaded.  In  the  stand-alone 
version,  the  user  is  prompted  for  a  file  name.  Xn  the  sub-program  version,  the 
initial  data  set  is  passed  as  arguments.  When  loading  a  new  data  set,  the 
previous  content  of  arrays  1  to  9  is  always  lost  unless  the  next  data  set  is  not 
found  ("end  of  file  detected"  condition).  The  current  curve  specifications  are 
also  lost. 


1  The  VMS  command  "WP  /Convert-Graphic  in_fila  out_file"  is  used  to  convert 
the  file  generated  by  SPLOT  into  a  *.WPC  file.  The  *.WPG  file  can  be 
copied  to  a  PC  and  be  imported  into  WordPerfect  directly,  or  can  be 
further  edited  with  other  utilities,  such  as  DrawPerfect. 
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Each  data  sat  Is  given  a  unique  data  set  ID.  Only  arrays  with  the  same  ID 
can  be  plotted  against  each  another. 


3.3.1  MEET 


This  command  reads  the  next  data  set  from  the  currently  opened  file  and 
loads  It  Into  arrays  1  to  9.  Previous  content  of  arrays  A(1..9)  Is  lost. 

3.3.2  MEM 

This  command  closes  the  current  file  and  prompts  the  user  for  another  file. 
This  first  data  set  found  in  the  file  is  loaded  into  arrays  1  to  9.  Previous 
content  of  A(1..9)  is  lost. 


3.3.3  UOTMD 

This  command  'rewinds'  the  current  file  and  reads  the  first  data  set  again 
Into  arrays  1  to  9. 


3. 3. A  BMOTE 

This  command  copies  a  block  of  arrays  to  a  different  block.  A  new  ID  Is 
given  to  the  new  block. 

Syntax:  BMOVE  [11.12.13] 

This  commands  copies  consecutive  arrays  A(11..12)  Into  a  block  of  arrays 
starting  at  A(i3)  (arrays  A(i3. . 13+12-11+1}) .  If  no  argument  Is  given,  the 
arrays  A(1..9)  are  copied  into  AC11..19). 
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3.4  GRAPHIC  COMMANDS 


Connindi  in  this  group  change  the  appearance  o£  the  graph.  It  Is  possible 
to  change  the  grid  appearance,  add  titles  and  labels,  plot  curves  with  different 
line  styles  and/or  symbols.  It  is  also  possible  to  change  the  range  of  both  the 
x-exis  and  y-axls,  affectively  xooalng-in  a  portion  of  the  graph. 


3.4.1  DASH  cosMnd 

This  command  allows  one  to  specify  the  style  of  the  line  used  to  draw  a 
curve.  Initially,  the  line  style  is  'O',  which  correspond  to  a  solid-line.  The 
line  stria  is  associated  with  the  array(s)  specified,  and  remains  in  effect  until 
changed  with  the  "DASH"  coaaand.  or  until  the  array  cleared  or  superseded.  The 
line  style  is  also  affected  with  the  "SCALE"  comaand.  The  line  style  is 
preserved  (l.e.  copied)  when  an  array  is  aoved  into  an  other  one  with  the  "HOVE" 
comaand,  but  it  is  not  presarved  with  the  "BMOVE”  command. 

Syntax:  DASH  il [ , 12] . icode 

where  'il'  and  '12'  represent  the  Index  of  one  array,  A(il),  or  a  range  of  arrays 
A(il..i2),  to  which  a  line  style  'icode'  wi.il  be  assigned.  The  Table  1  below 
lists  tha  possible  values  of  'icode'.  Curve  2  on  Figure  3-1  shows  the  effect  of 
changing  the  line  style.  See  also  the  "SYMBOL"  comaand. 

The  following  coaaand  is  used  to  specify  the  line  style  used  by  the  "SCALE” 
command: 


DASH  -1. icode 


3.4.2  GRID  command 

This  coaaand  sets  tha  appearance  of  the  grid  and  axis.  Figure  3-2  shows 
the  appearance  of  the  various  grid  types.  The  default  when  SPLOT  is  started  is 
4.  If  no  argument  is  given,  4  is  assumed. 
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Value 


Lina  »tvla 


a  11  Software  dash,  aaa  balow 

9  Alternate  aoves  and  draws  batwaan  data  points 

4  Long  dash 

3  Mediua  dash 

2  Alternate  of  short  and  long  dash 

1  Short  dash 

0  Solid  line  (default) 

-1  No  line 

•2  Vertical  bar 

•3  Horizontal  bar 

-4  Point  plot 

•S  Solid  line  (sane  as  0) 


Software  dashes  are  obtained  by  concatenating  integers 
describing  the  line  segnent  and  visibility  by  alternating 
visible  and  Invisible  segaents. 

1  3  raster  units  visible 

2  3  raster  units  invisible 

3  10  raster  units  visible 

4  10  raster  units  invisible 

3  23  raster  units  visible 

6  23  raster  units  invisible 

7  SO  raster  units  visible 

8  30  raster  units  invisible 


Table  1.  Values  for  specifying  line  types. 
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Syntax:  GRID  [11] 


where  'll*  la  a  coda  batwaen  0  and  4: 

0:  Only  tha  bottom  and  left  axis  are  drawn,  with  tic  narks  on  the 

outside. 

1:  Only  tha  bottoa  and  left  axis  are  drawn,  with  tic  narks  on  the 

inside. 

2:  Box  drawn  around  graph,  with  tic  narks  on  the  botton  and  left,  on 

tha  inside. 

3:  As  '2',  but  the  axis  x«G  and  y— 0  are  also  drawn  if  they  fall  within 

tha  graph. 

4:  Box  and  grid  drawn,  with  tic  narks  on  the  bottoa  and  left. 

3.4.3  SYMBOL  command 

This  coamand  allows  one  to  specify  a  symbol  to  be  drawn  at  every  data 
points.  Initially,  no  symbols  are  drawn  and  only  the  connecting  lines  between 
data  points  are  drawn.  The  synbol  value  is  associated  with  the  array (s) 
specified,  and  reaalns  in  effect  until  changed  with  the  "SYMBOL"  command,  or 
until  the  array  cleared  or  superseded.  The  symbol  value  is  preserved  (l.e. 
copied)  when  an  array  is  moved  into  an  other  one  with  the  "MOVE"  command,  but  it 
is  not  preserved  with  the  "BMOVE"  command. 

Syntax:  SYMBOL  il [ , 12] , icode 

where  'il'  and  '12'  represent  tha  index  of  one  array,  A{11),  or  a  range  of  arrays 
A(il..l?},  co  which  a  symbol  value  'icode'  will  be  assigned.  Table  2  below  lists 
the  possible  values  of  'icode'  .  Symbols  can  be  plotted  with  or  without  a 
connecting  line.  Curves  3  and  4  on  Figure  3-1  shows  the  effect  of  using  a  symbol 
with  and  without  a  line.  See  also  the  "DASH”  command. 
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Value 


Symbol 


-1  or  0 
1 
2 

3 

4 

5 

6 

7 

8 

9 

10 
11 


o 

* 

a 

□ 

* 

o 

I 

+ 

I 

1 

y 


None 

Circle 

"X" 

Triangle 

Box 

Star 

Diamond 

Vertical  bar 

Croat 

Op  arrow 

Down  arrow 

Reverse  triangle 


33  f  value  s  127 


Corresponding  ASCII  character  centered 
on  the  point. 


Table  2.  Values  for  specifying  symbols . 


It  Is  also  possible  to  specify  the  size  of  all  symbols  (1  being  the  default 
size)  with  the  command: 

SYMBOL  -l.size 

where  'size*  Is  a  relative  size  compared  with  the  default  size. 


3.4.4  TITC  command 

This  command  displays  a  title  centered  on  the  first  line.  It  can  be  used 
in  conjunction  with  the  "TITL"  and  "TITR"  commands. 
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Syntax:  TITC  (text] 


where  'text'  is  a  line  of  up  to  60  characters,  which  can  include  spaces.  This 
field  is  initially  empty.  It  is  also  cleared  with  the  "NEW"  command  with  the 
stand-alone  version  only. 


3.4.5  TTTL  cowend 

This  coaaand  displays  a  title  on  the  left  of  the  first  line.  It  can  be 
used  in  conjunction  with  the  "TITC"  and  "TITR"  commands. 

Syntax:  TITL  [text] 

where  'text'  is  a  line  of  up  to  60  characters,  which  can  include  spaces.  This 
field  is  initially  empty  for  the  subroutine  version  and  initially  set  to  the 
initial  data  file  name  for  the  program  version.  The  "NEW"  command  also  sets  this 
field  with  the  file  name  for  both  versions. 

3.4.6  TITR  command 

This  command  displays  a  title  on  the  right  of  the  first  line.  It  can  be 
used  in  conjunction  with  the  "TITC"  and  "TITL"  commands. 

Syntax:  TITR  [text] 

where  'text*  is  a  line  of  up  to  60  characters,  which  can  include  spaces.  This 
field  is  initially  set  to  the  current  date  (on  first  entry  only;  subsequent 
entry  of  the  subroutine  version  leaves  this  field  unchanged).  The  "NEW"  command 
of  the  stand-alone  version  also  sets  this  field  with  the  current  dete. 


3.4.7  XTJtBKL  command 

This  command  displays  a  label  centered  below  the  x-axis. 
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Syntax:  XLABEL  [text] 

where  ' taxt ’  la  a  Una  of  up  to  60  characters,  which  can  include  spaces. 

« 

3.6.1  XSCALE  co— nd 

This  command  scales  the  x-axis  (for  all  curves).  For  example,  a  scaling 
factor  of  10*  will  draw  the  x-axis  in  nanosecond. 

Syntax:  XSCALE  [s] 

where  's'  is  the  scaling  factor  (real  number).  With  no  argument,  the  scaling 
factor  is  cleared. 

i 

i 

*  I 

3.4.9  XHXDOV  com— d 

t 

This  command  zooms-in  a  portion  of  the  x-axis.  It  allows  one  to  specify 
the  range  of  the  x-axis.  It  supersedes  the  autoranging  function  defined  in 
Section  3.1. 

Syntax :  XUINDOU  ( , )  x^ ] 

where  'x^,,'  and  'x*,*'  specify  the  range  (real  numbers) .  If  'x^,/  is  not 
specified,  the  range  will  be  0.  to  *x_Tr' .  If  no  argument  is  given,  the  zoom 
function  is  cancelled  and  autoranging  resumes. 


3.4.10  TSCALE  command 

This  command  scales  the  y-axis  (for  all  curves).  For  example,  a  scaling 
factor  of  0.001  will  draw  the  y-axis  in  millivolts. 

Syntax:  YSCALE  [s] 
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where  'a'  is  the  seeling  factor  (reel  number).  With  no  argument,  the  scaling 
factor  is  cleared. 


3.4.11  WINDOW  command 

This  coaaand  scons- In  a  portion  of  the  y-axis .  It  allows  one  to  specify 
the  range  of  the  y-axis.  It  supersedes  the  autoranging  function  defined  In 
Section  3.1. 

Syntax :  WINDOW  [  (y^,, .  ] ym„ ] 

where  'ymln'  and  *v-.. '  specify  the  range  (real  lumbers).  If  'ymiB'  Is  not 
specified,  the  range  will  be  0.  to  * v... ' .  If  no  arguaent  is  given,  the  zoom 
function  is  cancelled  and  autoranging  resuaes. 


3.3  DATA  MANIPULATION  COMMANDS 

Comaands  In  this  group  alter  the  content  of  one  or  more  arrays  by 
performing  operations  onto  them. 


3.5.1  ABS  command 

This  command  computes  the  absolute  value  of  an  array.  A(il),  and  stores  the 
result  back  into  it. 

Syntax;  ABS  11 


3.5.2  ADD.  SUB,  MUL  and  DIP  commands 

These  commands  add,  subtract,  multiply  or  divide  two  arrays, 
A(ll)  op  A(i2) ,  end  store  the  result  back  into  A(12). 

Syntax:  ADD  11,12 
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3.5.3  AS  DC,  STTBC ,  HOLC  and  DIYC  cowindi 


These  coaaands  add.  subtract,  multiply  or  divide  an  array,  A(il),  with  a 
constant,  and  store  the  result  back  into  A(il). 

Syntax:  ADDC  11, c 

3.5.4  COMPRESS  cowand 

This  command  operates  on  all  curves  (l.e.  a  complete  data  set)  having  the 
saae  IS  as  the  specified  curve,  A(ll).  It  declaates  (l.e.  compress)  ell  arrays 
by  sub- indexing ,  l.e.  for  arrays  on  'n'  points,  stored  in  A(l;l..n),  only  the 
data  points  A(l;k),  for  k  froa  'start*  to  'stop*.  Incremented  by  'step'  are  kept 
(1  specifies  all  curves  with  the  saae  IS).  See  also  the  "XCOMPRESS"  command. 

Syntax:  COMPRESS  11, step  or 

COMPRESS  1 1, start , stop (, step] 

If  only  'step'  Is  specified,  'start-1'  and  'stop-n'  are  assumed.  If  only 
'start'  and  'stop'  are  specified,  'step*l'  is  assumed. 


3.5.5  DB  command 

This  command  computes  the  decibel  value  (10-LOG10x)  of  an  array,  A(ll),  and 
stores  the  result  back  into  it.  Data  points  less  or  equal  than  zero  are  assigned 
the  'not-a-number'  value  and  will  not  be  plotted. 
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Syntax:  DB  11 


3.3.6  HIT  eoaind 

This  command  computes  the  multiplicative  Inverse  (1/x)  of  an  array,  A(ll), 
and  stores  the  result  back  into  it.  Data  points  equal  to  zero  are  assigned  the 
#not-a-number’  value  and  will  not  be  plotted. 

Syntax:  1NV  il 


3.3.7  MOVE  or  COPT  commands 

The  "HOVE”  command  ("COPY"  is  a  synonymous)  copies  the  content  of  an  array, 
A(il) ,  into  another  erray,  A(i2).  The  content  of  A(12)  is  lost.  The  line  style 
end  the  symbol  code  are  also  copied  along.  The  new  array,  A(12),  retains  the 
same  ID  as  A(ll).  See  also  the  "BMOVE"  command. 

Syntax:  HOVE  11,12 

3.3.8  NEC  conund 

This  comaand  computes  the  negates  (-x)  an  array,  A(ll),  and  stores  the 
result  beck  into  it. 

Syntax:  NEG  il 

3.5.9  PHASE  command 

This  command  assumes  that  the  content  of  the  specified  array,  A(il), 
represent  a  phase  curve  in  degrees.  Often,  when  a  phase  curve  is  generated 
numerically,  it  results  in  a  curve  that  wraps-around  introducing  steps  of  360* 
due  to  the  inherent  characteristics  of  the  inverse  trigonometric  functions  (they 
may  return  an  angle  in  the  range  *180  <  0  s  +180  or  -270  <  0  s  +90  for  instance). 
In  some  other  algorithms,  the  phase  step  may  be  different  than  360*.  To  cover 
both  cases,  two  algorithm  to  unwrap  the  phase  were  implemented.  The  first  one 
assumes  that  the  phase  Jumps  by  t360*  and  will  add  or  subtract  a  360*  offset  when 
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needed  Co  unwrap  the  curve.  The  second  algorithm  will  locate  Jumps  larger  chan 
25*  and  extrapolate  the  curve  from  both  side  to  compute  the  offset.  The  second 
algorithm  will  fail  if  not  enough  data  points  are  given  when  the  phase  changes 
rapidly. 

Syntax:  PHASE  11 

The  following  command  it  use  to  specify  which  algorithm  to  use: 

PHASE  -1 ,n 

where  'n-1'  specifies  the  first  algorithm  (default)  and  'n-2'  specifies  the 
second  one. 


3.5.10  SOT  command 

This  command  (rotate)  performs  a  rotation  of  the  data  of  an  array,  A(ll), 
by  *n*  points  to  the  right  with  the  end  wrapping  to  the  beginning  if  positive, 
or  a  rotation  to  the  left  with  the  beginning  wrapping  to  the  end  if  negative. 
See  also  the  "SHIFT"  command. 

Syntax:  ROT  il.n 


3.5.11  SCALE  command 

This  command  multiplies  an  array,  A(il)  with  a  factor  such  as  its  peak 
value  (positive  or  negative)  matches  the  peak  value  of  an  other  array,  A(i2). 
The  resulting  array  is  written  back  into  A(il),  and  A(12)  is  unchanged.  By 
default,  the  lino  style  of  A(il)  is  set  to  dash  line  (see  "DASH"  command). 

Syntax:  SCALE  il [ . 12] 

If  '12'  is  not  specified,  the  scaling  factor  computed  the  last  time  the  "SCALE" 
command  was  called  is  used. 
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3.S.12  SHIFT  conind 


This  command  performs  s  shift  of  the  data  of  an  array,  Adi),  by  'n'  points 
to  the  right  if  positive  or  to  the  left  if  negative.  When  shifting  to  the  right 
(left),  the  *n’  rightmost  (leftmost)  points  are  discarded  and  the  'n'  leftmost 
(rightmost)  points  are  set  to  'not-a-number* .  See  also  the  "ROT”  command. 

Syntax:  SHIFT  11, n 

3.3.13  XCOMFRESS  command 

This  command  operates  on  all  curves  (i.e.  a  complete  data  set)  having  the 
same  ID  as  the  specified  curve,  A(il).  It  decimates  (i.e.  compress)  all  arrays 
by  sub-indexing,  i.e.  for  arrays  on  *n'  points,  stored  in  A(l;l..n),  only  the 
data  points  (in  all  arrays  with  the  same  ID)  for  which  A(l;k)  is  between  'xmin' 
and  'xmax'  are  kept.  See  also  the  "COMPRESS"  command. 

lyntax:  XCOMPRESS  11 , [xmin. ] xmax 

where  'xmin*  and  'xmax'  are  the  limits  against  which  the  array  A(ll)  will  be 
checked.  If  'xmin'  is  not  specified,  it  is  assumed  to  be  0. 

3.6  CURSOR  MODE  COMMANDS 

When  a  plot  is  completed,  the  program  (in  normal  mode)  will  signal  the  user 
('beep')  and  wait  for  a  "<CR>".  In  addition,  SPL0T  has  the  capability  to  enter 
what  is  called  the  cursor  mode,  in  which  it  is  possible  to  interactively  add 
elements  to  the  graph,  such  as  additional  titles  and  legends. 

Cursor  mode  can  be  entered  by  entering  "C"  and  then  "<CR>”  after  the  ploc 
is  completed.  A  cross-hair  cursor  will  be  displayed  which  can  be  moved  around 
by  using  the  thumbwheels  or  joydlsk  on  TEK401X  and  TEK411X  series  terminals,  or 
by  using  the  array  keys  on  DEC  VT2XX  and  7T3XX  terminals  and  on  PC  with  emulation 
software.  Cursor  mode  can  also  be  entered  automatically  upon  completion  of  the 
plot  with  the  "CURSOR”  command. 
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All  coaaunds  in  cursor  mode  are  one  letter  long  (no  "<CR>")  possibly 
followed  with  en  other  letter  or  numerical  entry.  To  return  to  the  "Command:  " 
prompt,  enter  a  single  space,  "<SP>",  without  a  "<CR>". 


All  additions  made  to  the  plot  are  shown  on  screen  and  can  be  either  saved 
in  a  file  or  sent  to  the  printer.  These  additions  are  in  effect  for  the  current 
plot  only  and  they  will  not  appear  on  subsequent  plots. 


3.6.1  CURSOR  command 

Upon  execution  of  this  command,  the  cursor  mode  will  be  entered  automati¬ 
cally  upon  completion  of  the  plot. 


3.6.2  <SP>,  Exit  cursor  mode 

In  cursor  mode,  the  space,  "<SP>",  is  used  Instead  of  "<CR>"  to  return  to 
the  "Command:  "  prompt. 


3.6.3  <0  command 

In  normal  mode,  when  waiting  for  a  "<CR>"  to  return  to  the  "Command:  " 
prompt,  typing  "C"  and  "<CR>"  will  enter  the  cursor  aode.  Cursor  mode  will  not 
be  entered  automatically  after  subsequent  plots. 


3.6.4  <B>  command 

This  command  draws  a  dash  line  from  the  last  stored  cursor  position  (with 
the  last  "<D>",  "<L>"  or  "<M>"  commands)  to  the  current  cursor  position. 
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3.6.5  <H>  coaund 

This  command  draws  a  horizontal  dash  line  across  the  plot  passing  through 
the  current  cursor  position. 


3.6.6  <L>  coeund 

This  coaaand  draws  a  solid  line  froa  the  last  stored  cursor  position  (with 
the  last  "<D>",  "<L>"  or  "<H>"  comaands)  'o  the  current  cursor  position.  This 
coaaand  is  particulary  useful  to  have  text  point  an  area  on  the  graph. 


3.6.7  <H>  coaaand 

This  coaaand  stores  the  current  cursor  position  for  further  use  with  "<D>" 
and  "<L>”  coaaands . 


3.6.8  <T>  coaaand 

Send  this  plot  to  the  printer  and  return  to  the  "Command:  "  proapt.  See 
also  the  "PRINT"  coaaand. 


3.6.9  <S>  coaaand 

This  coamand  resets  the  x-axis  and  y-axis  Halts  (see  the  "XWINDOU", 
"WINDOW"  and  "<Z>"  coaaands)  and  redraws  the  plot  using  autoranging. 


3.6.10  <S>  coaaand 

This  coaaand  draws  a  symbol  at  the  current  cursor  position.  After  "S"  is 
typed,  the  prograa  waits  for  the  user  to  enter  the  syabol  value,  followed  by  a 
"<CR>";  the  user  entry  is  not  echoed  on  screen.  See  the  "SYMBOL"  coamand  for 
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a  description  of  the  possible  values.  The  size  of  the  symbol  will  be  the  same 
as  tha  siza  specified  with  the  "SYMBOL"  command. 


3.4.11  <▼>  command 

This  command  draws  a  vertical  dash  lina  bctobb  tha  plot  passing  through  the 
current  cursor  position. 


3.4.12  <Z>  command 

This  command  is  used  to  define  an  ataa  of  tha  graph  for  zoom-in.  Move  the 
cursor  anywhere  within  the  graph  araa  and  entar  "Z”.  A  vertical  and  horizontal 
line  will  be  draw  on  screen  to  make  a  box  along  with  the  crosshair  cursor. 
Position  the  cursor  again  and  enter  "<SP>".  The  comers  of  the  box  will  be  used 
to  change  the  limits  of  both  the  x-axls  and  y-axis.  aa  with  the  "XVINDOV”  and 
"WINDOW"  commands.  If  the  cursor  is  moved  horizontally  only,  the  limits  for  the 
y-axls  will  not  be  changed;  if  it  la  moved  vertically  only,  the  limits  for  the 
x-axls  will  not  be  changed.  If  "C"  in  entered  Instead  of  "<SP>",  the  operation 
is  cancelled. 


3.4.13  <’>  command 

This  command  is  used  to  display  a  line  of  text  starting  at  the  current 
cursor  position.  "<CR>"  is  used  to  terminate  entry  of  text.  Small  characters 
are  used. 

3.4.14  <*>  command 

This  command  is  used  to  display  a  line  of  text  starting  at  the  current 
cursor  position.  "<CR>"  is  used  to  terminate  entry  of  text.  Large  characters 
are  used. 
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4 . 0  CONCLUSION 


Hose  simulation  codes  available  on  mainframe  computers  lack  the  data 
analysis  and  display  capabilities.  Many  of  these  codes,  such  as  SPICE,  NEC. 
EFIE,  etc.,  produce  an  output  file  in  a  formatted  fora  which,  when  printed,  can 
be  a  few  Inches  thick.  Furthermoi.,  It  la  frequent  for  researchers  to  design 
their  own  numerical  simulation  tools  to  meet  their  very  special  requirements  and 
addition  of  display  capability  requires  considerable  effort  and  thus,  is  not 
generally  dona. 

The  programs  described  In  this  report  were  designed  to  add  analysis  and 
display  capability  to  almost  any  simulation  code.  They  can  also  be  incorporated 
into  other  codes  to  provide  the  same  capabilities  dynamically,  la.  while  the  code 
is  executing.  The  data  la  obtained  from  the  outputs  of  one  or  more  simulation 
codes,  allowing  the  comparison  of  results  from  different  runs  or  different  codes 
running  the  same  problem.  The  data  can  be  manipulated  to  extract  and  display  the 
desired  quantities. 

These  programs  have  become  our  primary  tool  for  analyzing  computer 
generated  data  and  have  considerably  Increased  the  usefulness  of  many  simulation 
codes  as  they  greatly  reduced  the  time  required  to  analyze  the  results. 
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APPENDIX  A 


COMMAND  SUMMARY 


CONTROL  COMMANDS 

Terminate  SPLOT 

Sand  tha  last  plot  to  a  LN03+  printer 
Save  tha  last  plot  in  a  file 
Suspend  execution  &  spawn  a  subprocess 


END  EXIT  QHIT  or  CTRL/2 

PRINT 

SAVE 

SPAWN 


DATA  FILE  COMMANDS 

NEXT 

NEW 

REWIND 

BMOVE  [11,12,13] 


Read  the  next  data  set  from  file 

Open  a  new  file  and  read  the  first  data  set 

Read  the  first  data  set  again 

Move  a  block  of  arrays  Adi. .  12}  in  A(13. . . ) 
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GRAPHICS  COMMANDS 


DASH  11 [ , 12] , icode 
GRID  Icode 
SYMBOL  11 1.121. Icode 
TITC  (text] 

TXTL  [taxt] 

TXTR  [taxt] 

XLABEL  [text] 

XSCAT  Z  s 

XWINDOW  (\aln[ .xaaxj  ] 
Y  SCALE  4 

YVXNDCW  (yaln[ ,yaax] ] 


Specify  line  type 

Specify  grid  and  axis  type 

Specify  symbol  code  ( 11-- 1  to  specify  size) 

Specify  centered  title 

Specify  left  title 

Specify  right  title 

Specify  x-axis  label 

Specify  scale  factor  for  x*axis 

Specify  x-axls  range 

Specify  scale  factor  for  y-axis 

Specify  y-axls  range 


irrr  TuritMinemr 


DATA  MANIPULATION  COMMANDS 


ABS  11 
ADD  11.12 
ADDC  11. C 

COMPRESS  11, (start. atop, J [step] 

DB  11 

DIV  11,12 

D1VC  11. c 

INV  11 

MOVE  11,12 

MOL  11.12 

MOLC  11. e 

NEC  11 

PHASE  11 

ROT  11. n 

SCALE  11| . 12] 

SHIFT 
SUB  11,12 
SUBC  11. c 

XCOMPRESS  11 , [xmin, ]xmax 


(11)  -  |(11)| 

(12)  -  (11)  ♦  (12) 

(11)  -  (11)  ♦  c 
Compress  data  sat  by  Index 

(11)  -  20'LOG( (11)) 

(12)  -  (11)  /  (12) 

(11)  -  (11)  /  c 
(11)  -  1  /  (11) 

(12)  -  (11) 

(12)  -  (11)  x  (12) 

(11)  -  (11)  x  e 
(11)  -  -(11) 

Adjust  phase  (11--1  to  specify  algorithm) 
Rotate  date  (positive-right) 

Scale  (11)  to  fit  (12) 

Shift  data  (positive-right) 

(12)  -  (11)  -  (12) 

(11)  -  (11)  -  c 

Compress  data  set  by  value  (xmlns(il)sxmax) 
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CURSOR 

C 

D 

H 

L 

M 

P 

R 

S 

V 

z 


<SP> 


Enable  automatic  cursor  mode 

Enter  cursor  mode 

Draw  a  dash  line 

Draw  a  horizontal  dash  line 

Draw  a  line 

Set  cursor  position  for  *D'  &  ’L' 

Print  graphic 

Reset  x  6  7  limits 

Draw  a  symbol 

Draw  a  vertical  dash  line 

Zoom- in 

Write  text  on  screen  (small  characters) 
Write  test  on  screen  (large  characters) 
Exit  cursor  mode 
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a  tut  dcrite  pour  permeate  I'affichage  de  rteultats  durant  1’ execution  de  programmes  de  simulation.  Ce  rapport  donne  une 
description  ddtailld  des  programmes  et  de  leurs  commandes. 
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